home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 551-575 / disk_567 / mouseaidedemo / mouseaide.doc < prev    next >
Text File  |  1992-05-06  |  11KB  |  269 lines
  1. MouseAide  v2.56a.11.01.91
  2. Copyright © 1991 by Thomas J. Czarnecki
  3. All Rights Reserved
  4.  
  5.  
  6.  
  7.     "MouseAide" is a 100% machine language program that helps the Mouse do
  8.     much more, with a lot less work!
  9.  
  10.  
  11.                             MouseAide Features:
  12.  
  13.  
  14.     o   An adjustable acceleration of the mouse, with a adjustable threshold
  15.         for fast, and easy precision work.
  16.  
  17.     o   Auto-Activation of the window that the mouse pointer is under
  18.         (Not active is there is a Icon Select, or a Menu Select, for
  19.         obvious reasons!)
  20.  
  21.     o   Auto-Key-Activation of the window that the mouse pointer is
  22.         under, when a key is pressed.  Nice feature to have if you use
  23.         the keyboard with multiple windows.  Just point and type!
  24.  
  25.     o   Blanking of the mouse pointer if a key is pressed.  No more trying
  26.         to read behind the mouse pointer, Nice eh?
  27.  
  28.     o   Blanking of the mouse pointer if user input is idle for a set
  29.         number of seconds.
  30.  
  31.     o   To save your monitor from image burning: blanking of the screen
  32.         if the user input is idle for a set number of minutes. Nice
  33.         feature for those of us that take a one minute break that runs
  34.         into....
  35.  
  36.     o   Clicking a window under the mouse pointer to the front (if need be)
  37.         with a adjustable number of left mouse button clicks, that are
  38.         within the time you have set in preferrences.  The clicks to front
  39.         count is reset when the mouse pointer is moved to a new window, making
  40.         unwanted 'Clicks To Front' less likely when using a click count of two
  41.         or more.
  42.  
  43.     o   Clicking a window under the mouse pointer to the back, by holding the
  44.         left mouse button down while clicking and releasing the right mouse
  45.         button!
  46.  
  47.     o   Clicking the screen to the back, by doing a doing a window to back
  48.         sequence, but with the mouse pointer NOT over a window!
  49.  
  50.     o   Turning the windows with the 'Left Amiga-J', & 'Left Amiga-K' keyboard
  51.         sequences.  The top window will become the active one!
  52.  
  53.     o   Turning the screens with the 'Left Amiga-N', & 'Left Amiga-M' keyboard
  54.         sequences.  The top screen will become the active one!
  55.  
  56.     o   If any conflicts arise "MouseAide" can be suspended by the keyboard
  57.         sequence: Left-Amiga-Right-Shift  And restarted with the same sequence!
  58.         This allows you to enter any key/mouse input that "MouseAide" may use,
  59.         without getting the action (Click-to-front, Window/Screen turning...)
  60.  
  61.     o   Can execute a default ('c:NewCLI') or a user defined command with the
  62.         'Left Amiga-Esc' keyboard sequence.  Nice for a quick-pop-up program,
  63.         or a easy CLI/Shell startup.
  64.  
  65.     o   Multi-Icon-Select with just the mouse, No more shift key!  By pressing
  66.         and holding the left mouse button, then pressing and holding the right
  67.         mouse button, and then releasing the left mouse button, you enter the
  68.         Multi-Icon-Select (M.I.S.) mode!  To select multiple Icons just click
  69.         on them with the left mouse button while still holding down the right
  70.         mouse button!  You can enter the M.I.S. mode while selecting your first
  71.         Icon, or, as I find easier, you can enter M.I.S. mode by doing the above
  72.         sequence without an Icon!  It makes it easier to select the first Icon
  73.         without moving it!
  74.  
  75.     o   You can switch which port (1 or 2) that the mouse uses with the key
  76.         sequence: 'Left Amiga-P'  Did you buy a TrackBall for your favorite
  77.         graphics program, but prefer to use the mouse for your non-graphics
  78.         work, well plug the TrackBall in Port2 and switch between the mouse
  79.         and TrackBall on the fly with a few keys!
  80.  
  81.     o   Workbench Window to Front with the 'Left Amiga-W' (The default for this
  82.         function is: Off, so to use this fuction you must enable  with the '+w'
  83.         switch when installing "MouseAide")  I created this function because
  84.         with just a few open windows on the 'Workbench Screen' I could NOT get
  85.         at the disk icons!  When you activate this function the 'Workbench'
  86.         Window will come to the front, allowing you to open a disk/volume
  87.         icon.  When you open a window or use the 'Left Amiga-W' sequence again
  88.         the 'Workbench' Window will pop back!  NOTE: I read that the Workbench
  89.         2.0 Window can be depth-arranged, so my program will detect this and
  90.         only bring the window to the front, NOT pop it back (I do NOT have
  91.         access to a 2.0 machine, so this function is untested for 2.0)
  92.  
  93.     o   Freezing of the mouse and keyboard of all input, which if you live with
  94.         small children or a keyboard climbing critter, can be a real life-
  95.         saver!  Just use the 'Left Amiga-Right Amiga-Z' keyboard sequence to
  96.         toggle in/out of the input freezing mode.  When you enter the input
  97.         freezing mode all mouse and keyboard input (except for the key sequence
  98.         to toggle you back) will be frozen, also the mouse and screen will
  99.         blank until you leave this mode.  This fuction is great for those long
  100.         running programs, that you start up and leave alone for a long period
  101.         of time!
  102.  
  103.     o   Can switch the right & left mouse buttons when installed for those left
  104.         handed people out there!  (Use the '+l' option listed below)
  105.  
  106.     o   Adjustable priority of the 'Input Handler'  The default is: 57, and
  107.         should be fine for most of you.  But if you are using another program
  108.         that also uses a 'Input Handler' than this option maybe nice to have!
  109.  
  110.     o   Easy WorkBench & CLI startup and shutdown!
  111.  
  112.     o   Releases every byte of memory on shutdown.  No dead data, or code is
  113.         left in the system!  Did you ever notice, after running some programs,
  114.         how your free memory seems less?  Well it is!  But, NOT after running
  115.         "MouseAide"  It cleans up after itself!
  116.  
  117.     o   The options can be user defined by Workbench or CLI/Shell
  118.  
  119.     o   Very small in size, under 5K in size, and even smaller with your
  120.         favorite executable compressor (Turbo Imploder, PowerPacker...)
  121.  
  122.     o   Self-detaching,  for ease of startup!
  123.  
  124.     o   Uses advanced (Semaphore locked) static & dynamic memory management
  125.         techniques to reduce memory thrashing, while also keeping memory
  126.         demands low!
  127.  
  128.     o   Uses "good" programing practices!,  Not like most of the "Mouse"
  129.         programs floating around!  No "Intuition" calls are made from the
  130.         high-priority 'Input Handler', a very bad practice that most of the
  131.         "Mouse" programs use!
  132.  
  133.     o   The 'Input Handler' runs at a high priority, but the time wasting
  134.         part of the program run at a low priority
  135.  
  136.     o   The one-shot data & code (start-up, shut-down, etc...) is release
  137.         after start-up to further reduce memory overhead!
  138.  
  139.  
  140.  
  141.     To startup "MouseAide" from WorkBench just double-click on "MouseAide" Icon!
  142.  
  143.     From CLI type: MouseAide<RETURN>
  144.  
  145.         (Note: That the program is self-detaching, do NOT Run it!
  146.                It also sets the correct stack-size and priority, don't
  147.                waste time adjusting them!)
  148.  
  149.     To remove "MouseAide" just start up the program again.
  150.  
  151.  
  152.     All options (switchable, value & command) have a default setting. The value
  153.     defaults are set as following:
  154.  
  155.             Acceleration Factor     -   3
  156.             Threshold Factor        -   2
  157.             Clicks to Front         -   1
  158.             Mouse Blanking          -   5 Seconds
  159.             Screen Blaking          -   5 Minutes
  160.             Input Handler Priority  -   57
  161.  
  162.     The default options can be changed by the user by using the option line.
  163.     By using the '+' & '-' switches, the user can turn ON or OFF any option.
  164.     All the switchable options, but, Left-Handed-Swap and the Workbench
  165.     window to front, are by default: On.
  166.  
  167.     The switchable options are:
  168.  
  169.             "a" -   Auto-Activate
  170.             "f" -   Click to Front
  171.             "b" -   Click to Back
  172.             "m" -   Mouse Blanking
  173.             "s" -   Screen Blanking
  174.             "t" -   Key Turning
  175.             "e" -   Key-Activte
  176.             "k" -   Key-Mouse Blanking
  177.             "i" -   Multi-Icon-Select
  178.             "p" -   Port swapping for the Mouse
  179.             "l" -   Left-Handed-Swap (Off by default)
  180.             "w" -   Workbench Wndow to Front (Off by default)
  181.  
  182.  
  183.     Value options are set by an integer number following the Option to be set.
  184.     The value is auto-ranged (limited) to a default value.
  185.  
  186.     The value options are:
  187.  
  188.             "A" -   Acceleration Factor (range:1-11)
  189.             "T" -   Threshold Factor (range:1-11)
  190.             "F" -   Click(s) need for window to Front (range:1-9)
  191.             "M" -   Mouse Blanking time in seconds (range:1-59)
  192.             "S" -   Screen Blanking time in minutes (range:1-59)
  193.             "P" -   Priority of the 'Input Handler' (range: 50-127)
  194.  
  195.     The last option is the 'C' (command) option.  This option must be the last
  196.     option to be set on the option line!  The syntax is:
  197.  
  198.             C <User defined string>
  199.  
  200.     If you do NOT define a command string the default 'c:NewCLI' will be used!
  201.  
  202.  
  203.     So, a few examples are now in order:
  204.  
  205.         For: No Auto-Activate, Mouse Blanking set to 7 seconds, a Acceleration
  206.         Factor set to 5, the Threshold Factor set to 3,  do Key-Activate and
  207.         Key-Mouse Blanking we would use this option line:
  208.  
  209.             -a M7 A5 T3 +ek
  210.  
  211.         For: No clicking to front, and No Key-Turning, and the command string
  212.         'AShell...' we would use this option line:
  213.  
  214.             -fe CAShell CON:0/11/0/0/MouseAideShell
  215.  
  216.         For: An Acceleration of 2, and a Threshold of 1, with 3 Clicks for a
  217.         Window to front, and the Workbench Window to Front option, we would
  218.         use this option line:
  219.  
  220.             A2 T1 F3 +w
  221.  
  222.  
  223.  
  224.         To use the option line in the CLI, just add it to the end of the line
  225.         on startup. For example:
  226.  
  227.             MouseAide +mstkef A4 T2 F3 M3 S1 CGShell
  228.  
  229.  
  230.         To use the option line from WorkBench, you can do it two ways:
  231.  
  232.             1: Writing "OPTIONS=option line" in the "Tool Types" field of
  233.              "MouseAide" Tool Icon.
  234.  
  235.             2: Writing "OPTIONS=option line" in the "Tool Types" field of
  236.              a Project Icon and 'MouseAide' in the "Default Tool" field.
  237.  
  238.         You can get good examples by Info(ing) the Icons included
  239.  
  240.  
  241.     Hint:  A console window with a lot of output may delay some "MouseAide"
  242.            functions!  A good trick is to hit the shift-key when this delay
  243.            happens.  The Shift key will be like a electric shock to the
  244.            system, breaking the delay.
  245.  
  246.  
  247.  
  248.  
  249.     Tempus Fugit,
  250.  
  251.         Czar
  252.  
  253.  
  254.  
  255.  
  256. If you have any ideas, comments, bugs to report, write me:
  257.  
  258.  Thomas J. Czarnecki
  259.  3526 Republic Avenue
  260.  Racine, WI 53405-3856
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.